home *** CD-ROM | disk | FTP | other *** search
/ Mac Mania 2 / MacMania 2.toast / Demo's / Tools&Utilities / Netwerk⁄Telecom / XTimer1.1.1 Folder / XTimer 1.1.1 / XTimer 1.1.1.rsrc / TEXT_128_Help Info.txt < prev    next >
Encoding:
Text File  |  1994-06-08  |  8.1 KB  |  213 lines
  1. What is XTimer?    
  2.  
  3. XTimer is a timer for calculating time based charges.
  4. The idea came from the desire to keep track of expenses while using
  5. extended service areas of CompuServe (CIS). I set off to make
  6. an "ex" timer.  Later, I expanded the idea to include users of
  7. different online services, such as America OnLine (AOL), GEnie,
  8. and Prodigy.
  9.  
  10. I thought a generic "X" timer might be useful, to keep track of
  11. long distance charges, for billing a client, or some other need.
  12. To make XTimer an  "X" timer,  I gave it the flexibility to be shaped
  13. to many different needs.
  14.  
  15. The charge rates are set to CIS, AOL, GEnie, and Prodigy rates,
  16. current as of this release. You can easily change them to whatever you
  17. like by selecting Preferences under the File menu.  XTimer is designed
  18. for use with the U.S. currency system. The maximum charge allowed,
  19. per hour, is $99.99. You can enter in your own rate description, up to
  20. 20 characters.
  21.  
  22.  
  23. How XTimer is Different From Other Timers    
  24.  
  25. The controls are like any standard timer, but the time shown is
  26. a little different. The time shown is the time you've been charged
  27. for, each minute or part of a minute counts as a full minute. This
  28. is the way most time based charges are calculated. The seconds
  29. left in the current minute being charged, before the next minute
  30. will be charged, are shown as an added help.
  31.  
  32. You can minimize, or maximize the timer by choosing the option under the
  33. File menu, or clicking in the grow window of the timer. Holding the option
  34. key down and clicking in the grow window of the maximized timer will show
  35. or hide the "Next Notice at..." message.
  36.  
  37. The minimized "stoplight" version of the timer, allows you to save desktop
  38. space, while retaining most of the functionality of the timer. Use the green
  39. light to start (G button in B&W), red to stop (S in B&W), and the
  40. yellow button to reset (R in B&W).
  41.  
  42. The timer can log up to 100 hours, after that it will turn over to zero.
  43. (If you should happen to let it run for more than four days!)
  44.  
  45.  
  46. How Do I Total My Online Charges    
  47.  
  48. Most online services calculate hourly charges by totaling all of the times
  49. from a session (from log on, to log off) that you spent in areas where there
  50. were hourly charges. The total time is then rounded; if a partial minute is
  51. left, it is counted as a full minute, i.e.  a charge for 10 minutes 34 seconds
  52. is counted as  11 minutes.
  53.  
  54. You can round your time likewise, at the end of a session, by clicking the
  55. "Round" button, on the timer.
  56.  
  57.  
  58. The Auto-Return Feature    
  59.  
  60. This allows you to set XTimer to automatically return control to the
  61. program you were using after you Start, Stop, or Reset the timer.
  62. This enables you to use XTimer without having to reactivate another
  63. program afterwards.  XTimer can be brought to the front with
  64. Auto-Return on by unclicking Auto-Return, clicking on the window
  65. title bar, or by selecting XTimer from the Applications menu.
  66.  
  67.  
  68. Setting, Saving, Restoring, and Adding    
  69.  
  70. You can set the time to whatever needed, by choosing "Set Time" under
  71. the File menu.
  72.  
  73. You may:
  74.      Save the time on the timer as time charged for any rate.
  75.      Restore a time saved from any rate to the timer.
  76.      Add a time on the timer to charges already logged to any rate.
  77.  
  78. All of these options are available under the File menu. The rate currently
  79. selected under the Rate menu comes up as the default selection when you
  80. choose any of these options, but you may use any one of the rates, as you 
  81. like. If you choose a rate different from the default, the rate you choose
  82. becomes the current rate.
  83.  
  84. Saving, or Adding a time does not effect the time on the timer. You must use
  85. Restore to put a logged time back on the timer.
  86.  
  87. You can Save or Add any time to as many of the rate choices as you like.
  88.  
  89.  
  90. Viewing the Log     
  91.  
  92. You can review your charges and times charged for by selecting "View Log,"
  93. from under the file menu.
  94.  
  95.  
  96. The Notify Menu    
  97.  
  98. It seemed obvious that it would really be nice to warn yourself when
  99. a certain amount (x) of time had passed, without having to keep an
  100. eagle eye on the timer. The Notify menu is set up for that purpose.
  101.  
  102. The times on the menu represent interval times. If you set a
  103. notice to come at 10 minutes, for instance, the notice will arrive
  104. at the next 10 minute interval, i.e. at 10 minutes, 20 minutes, 30
  105. minutes, and so on. The notices will continue to come at the 
  106. interval you selected. If you check the box "Send Notices Early,"
  107. your notices will come at the beginning of that minute, rather than
  108. at the end.
  109.  
  110. You can choose to have the next interval time calculated based on
  111. the time you first started the timer (from zero), or from the time
  112. you last started  the timer, the next start  will be used if the timer
  113. is stopped. So, if the timer has 5 minutes of charges built up
  114. already when started, if the interval is 10 minutes, the notices
  115. would be sent at 15 minutes, 25 minutes, 35 minutes, and so on.
  116.  
  117. If you wish to set the next interval from the current time while the
  118. timer is running, and you don't want to stop the timer, select "START NOW"
  119. from the Notify menu and the "Last START" time will be set to the current
  120. minute.
  121.  
  122.  
  123. Using XTimer with MacCIM‚Ñ¢     
  124.  
  125. I've found the best way to use XTimer is to click on the start button
  126. during the transfer to an extended service area. XTimer activates on
  127. the first click, so you won't have to click twice. After that, click back
  128. in one of CIM's windows to reactive it, or use the Auto-Return feature.
  129.  
  130.  
  131. A Couple of Things to Note    
  132.  
  133. 1.  If you change the notice interval while the timer is running, you could
  134.       very well set it on the nose of the next notice time. If you do, the
  135.       notice will be sent, probably sooner than you were expecting!
  136.  
  137. 2.  This is true for many programs that use the system clock:
  138.       If you change the time on your Mac, say, back an hour in the fall,
  139.       or forward in the Spring, while XTimer is running, it may produce
  140.       unexpected results.
  141.  
  142. I hope XTimer is useful to you.  Enjoy!
  143.  
  144.  
  145. Short Cuts     
  146.  
  147. Command Key        Application
  148.          H                   Hide/Show timer
  149.          M                  Minimize/Maximize timer
  150.          T                   Set Time
  151.          D                   View Log
  152.          S                   Save Time As
  153.          R                   Restore Time From
  154.          J                   Add Time To
  155.          F                   Notify from First START
  156.          L                   Notify from Last START
  157.          U                   No Notice
  158.  
  159. Other command key short cuts are standard Mac command keys.
  160.  
  161. Other Shortcuts    
  162.  
  163.    <option> + Reset   Reset without asking confirmation
  164.    <option> + Start   Reset and Start
  165.    <shift> + <command> + Start
  166.                                   Add time on timer to current rate and Start
  167.    <shift> + <command> + <option> + Start
  168.                                   Adds time, but Resets before Start
  169.    <option> + <click>  In Maximized timer grow window to
  170.                                   Show/Hide "Next Notice at..." message
  171.  
  172.  
  173. System Requirements    
  174. XTimer Requires System 7.
  175.  
  176.  
  177. Legal Stuff    
  178.  
  179. XTimer ¬©1994  Eric Long.  All Rights Reserved.
  180. XTimer comes without warranty expressed or implied.  Use of
  181. XTimer is solely at your own risk, author is held without liability.
  182. XTimer may be distributed freely, so long as it is not sold or modified.
  183.  
  184. XTimer is shareware:
  185.        Send $5 to Eric Long, 4731 28th Avenue, Sacramento, CA 95820
  186.  
  187. Send E-mail to:
  188.        CompuServe    72764,1072
  189.        Internet           ericlong@macnexus.org
  190.  
  191. If not unexpectedly deluged with mail, I will try to respond, 
  192. when asked for a reply.
  193.  
  194. CompuServe¬Æ and MacCIM‚Ñ¢ are registered trademarks of CompuServe 
  195. Incorporated, Columbus, OH 43220
  196. America Online, Prodigy, and GEnie are trademarks of their respective
  197. holders.
  198. XTimer is not a product of, nor representative of CompuServe Incorporated,
  199. America Online Inc., GEnie, or Prodigy.
  200.  
  201.  
  202. Special Thanks    
  203.  
  204. My thanks to James W. Walker for his great plug-in Help screen code.
  205. Thanks to Paul Celestin for his PICTButton CDEF (control definition), which
  206. was used to make the minimized "stoplight" version of the timer's buttons
  207. work.
  208.  
  209. Thanks to my wife Donna, who made the XTimer icon, and designed the
  210. stoplight used in the minimized timer.
  211.  
  212. Thanks to everyone in MACDEV for their assistance, thanks to the beta
  213. testers.